-
get-query-schemaGet User Insights Query Schema -
query-usersQuery Users
Get User Insights Query Schema
Returns the registered field list (id, label, type, default visibility, filter config) and the operator registry per filter type. Call this first to discover valid `by` values and operators before calling query-users, since fields include dynamic ones (BuddyPress xProfile fields vary per site, custom fields vary per install). Requires install_plugins.
Takes no input.
Query Users
Filters, sorts, and paginates site users through the same query engine as the User Insights admin screen. Call get-query-schema first for valid `by` and `operator` values – fields vary per site (BuddyPress xProfile, custom fields). Results are automatically scoped to the current site on multisite installs. Requires install_plugins.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filters |
array of object | No | Filter conditions, ANDed together. Each item: {by: field id, operator: operator key for that field’s type, condition: value, type: field filter type}. See get-query-schema for valid values. | |
orderby |
string | No | Field id to sort by. Defaults to “registered”. | |
order |
string | No | Sort direction. Defaults to DESC. One of: ASC, DESC. |
|
search |
string | No | Matches part of the username, email or display name. Combined with the filters by AND. | |
number |
integer | No | 20 |
Max results to return. |
offset |
integer | No | 0 |
Pagination offset. |
